PUT api/meta/{id}?mode={mode}&clearGroup[0]={clearGroup[0]}&clearGroup[1]={clearGroup[1]}&addBodyToAudit={addBodyToAudit}&updateWFActivity={updateWFActivity}&clearPartialRows={clearPartialRows}&enforceMandatory={enforceMandatory}

Update meta values, note that updating fields that drive dependencies, calculations or linked items are not fully supported.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

the unique id to reference the item (this is either the asset inode or the userid depending on the mode

integer

Required

mode

'user' or 'asset' depending on type of item being updated

string

Default value is asset

clearGroup

The GUID or label of form grids/groups to be cleared

Collection of string

None.

addBodyToAudit

Determines if the full form body is added to audit trail table

boolean

Default value is False

updateWFActivity

boolean

Default value is False

clearPartialRows

boolean

Default value is True

enforceMandatory

boolean

Default value is False

Body Parameters

Meta Fields with the values to be updated

Collection of MetaField
NameDescriptionTypeAdditional information
GUID

unique GUID for this field

string

None.

iteration

The iteration (index of parent element)

integer

None.

index

The groupIndex (zero-based row index) of this value

integer

None.

entryGUID

Entry/row GUID for this field

string

None.

label

Field label (note a form may have the same label repeated so GUID is the only safe unique identifier)

string

None.

values

Array of values, most fields will have a single value here but certain fields like checkboxes may have multiple values

Collection of MetaValue

None.

Request Formats

application/json, text/json

Sample:
[
  {
    "GUID": "sample string 1",
    "iteration": 2,
    "index": 3,
    "entryGUID": "sample string 4",
    "label": "sample string 5",
    "values": [
      {
        "value": "sample string 1",
        "attributeid": 2,
        "fileID": 3,
        "userID": 4,
        "userGroupID": 5,
        "associatedItemID": 6,
        "other": true,
        "roleID": 8,
        "matrixID": 9,
        "matrixVersion": "sample string 10",
        "matrixName": "sample string 11",
        "tableGUID": "sample string 12",
        "matrixDisplayName": "sample string 13",
        "groupIdx": 14
      },
      {
        "value": "sample string 1",
        "attributeid": 2,
        "fileID": 3,
        "userID": 4,
        "userGroupID": 5,
        "associatedItemID": 6,
        "other": true,
        "roleID": 8,
        "matrixID": 9,
        "matrixVersion": "sample string 10",
        "matrixName": "sample string 11",
        "tableGUID": "sample string 12",
        "matrixDisplayName": "sample string 13",
        "groupIdx": 14
      }
    ]
  },
  {
    "GUID": "sample string 1",
    "iteration": 2,
    "index": 3,
    "entryGUID": "sample string 4",
    "label": "sample string 5",
    "values": [
      {
        "value": "sample string 1",
        "attributeid": 2,
        "fileID": 3,
        "userID": 4,
        "userGroupID": 5,
        "associatedItemID": 6,
        "other": true,
        "roleID": 8,
        "matrixID": 9,
        "matrixVersion": "sample string 10",
        "matrixName": "sample string 11",
        "tableGUID": "sample string 12",
        "matrixDisplayName": "sample string 13",
        "groupIdx": 14
      },
      {
        "value": "sample string 1",
        "attributeid": 2,
        "fileID": 3,
        "userID": 4,
        "userGroupID": 5,
        "associatedItemID": 6,
        "other": true,
        "roleID": 8,
        "matrixID": 9,
        "matrixVersion": "sample string 10",
        "matrixName": "sample string 11",
        "tableGUID": "sample string 12",
        "matrixDisplayName": "sample string 13",
        "groupIdx": 14
      }
    ]
  }
]

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'List`1'.

Response Information

Resource Description

None.